home *** CD-ROM | disk | FTP | other *** search
/ CD Exchange / CD Exchange - Volume 1.iso / utils / misc / split! / split!.doc < prev    next >
Encoding:
Text File  |  1993-12-12  |  3.1 KB  |  104 lines
  1.  
  2. Split! 1.0
  3.  
  4. User Manual
  5.  
  6. December 11, 1993
  7.  
  8.  
  9.  
  10. INTRODUCTION
  11.  
  12.     Frequently, I had to move large files between platforms.  When I
  13.         had a 10 megabyte file on my Amiga hard disk that I wanted to take
  14.         to school (an IBM network) for printing, I found that when I LhAed
  15.         the file, it still wouldn't fit on a floppy disk.  After trying
  16.         other file splitters, I found that they were just too slow for my
  17.         needs.  I wrote my own.
  18.  
  19.  
  20. INSTALLATION
  21.  
  22.     Split! is a CLI-based command, and therefore should be placed
  23.         somewhere in your command path.  I reccomend that you move the
  24.         executable to your C: directory before use.
  25.  
  26. USAGE
  27.     
  28.     Split! must be run from the CLI, and takes only two parameters:  
  29.  
  30.     Split! <infile> <outfile>
  31.  
  32.     <infile> is the large file you want to split up into smaller files.
  33.  
  34.     <outfile> is the root of the destination filename.  For each file
  35.           created, a numerical extention will be added.
  36.  
  37.     Once run, Split! will ask you how big (in Kilobytes) to make each
  38.         <outfile>.  To transport it on standard MS-DOS 720k disks, I would
  39.         reccomend a split size of 700.  For 1.44Mb MS-DOS disks, enter 1400.
  40.  
  41.     Example:
  42.  
  43.     Split BigFile LittleFile
  44.         SplitSize (Kb): 700
  45.  
  46.         The files would be called:  LittleFile.1, LittleFile.2, etc.
  47.  
  48.         
  49.         On the MS-DOS system, you just copy all the files off the disks
  50.         into a directory on the hard disk.  The MS-DOS 'COPY' command
  51.         does a good job of putting them back to gether.
  52.  
  53.         COPY LittleFile.1/b+LittleFile.2/b+LittleFile.3/b BigFile
  54.  
  55.         This would join all the smaller files into a larger one called
  56.         'BigFile.'  The '/b' switch on each file is important.  It tells
  57.         COPY that it is joining binary files, and thus will not stop at
  58.         the first CTRL-Z it sees.
  59.  
  60.  
  61. BENCHMARKS
  62.  
  63.         These tests where done with the file NodeList.316, the FidoNet
  64.         nodelist.  The source file was 2212118 bytes long.  The splitsize
  65.         in both cases was 700k.
  66.  
  67.         Split! 1.0       Chopper 1.1
  68.         ==========       ===========
  69.  
  70.         10.23 sec.       140.21 sec.
  71.  
  72.  
  73. LIMITATIONS
  74.  
  75.         Alas, the programs speed is not a result of my programming 
  76.         prowess.  It is simply because of my big-assed buffer!  By
  77.         processing 32k at a time, your systems hard disk has to seek
  78.         less.  Unfortuantely, this is demanding on _very_ low memory
  79.         systems.  I would have included my PCQ Pascal source code, 
  80.         but I'm too embarrased.
  81.  
  82. DISTRIBUTION
  83.  
  84.         Although this program is freely distributable, it remains _my_
  85.         program, Copyright (c) Dan Fraser, 1993.
  86.  
  87.         I shall impose a few limitations on distribution.  It must not be
  88.         _sold_ for profit.  It must not be placed in public domain
  89.         collections for which more than $4 a disk is charged, and it may
  90.         not be used in commercial product distributions without my written
  91.         permission.
  92.  
  93. CONTACTING THE AUTHOR
  94.  
  95.         Dan Fraser
  96.         FidoNet: 1:221/125.1
  97.         
  98.         Snail Mail:
  99.  
  100.         88 Windsor Avenue 
  101.         London, Ontario
  102.         CANADA
  103.         N6C 1Z9
  104.